View 1991680_280927.PDF datasheet online --- IC-ON-LINE

Datasheet File OCR Text:

FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
PM7380, PM7381, PM7382, PM7383, PM7384, PM7385
FREEDM-NG DEVICE DRIVER
RELEASE NOTES
PROPRIETARY AND CONFIDENTIAL RELEASED ISSUE 3: DECEMBER, 01
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
LEGAL INFORMATION
Copyright
(c) 2001 PMC-Sierra, Inc. All rights reserved. The information is proprietary and confidential to PMC-Sierra, Inc., and for its customers' internal use. In any event, you cannot reproduce any part of this document, in any form, without the express written consent of PMC-Sierra, Inc. PMC-1991680 (R3)
Disclaimer
None of the information contained in this document constitutes an express or implied warranty by PMC-Sierra, Inc. as to the sufficiency, fitness or suitability for a particular purpose of any such information or the fitness, or suitability for a particular purpose, merchantability, performance, compatibility with other parts or systems, of any of the products of PMC-Sierra, Inc., or any portion thereof, referred to in this document. PMC-Sierra, Inc. expressly disclaims all representations and warranties of any kind regarding the contents or use of the information, including, but not limited to, express and implied warranties of accuracy, completeness, merchantability, fitness for a particular use, or non-infringement. In no event will PMC-Sierra, Inc. be liable for any direct, indirect, special, incidental or consequential damages, including, but not limited to, lost profits, lost business or lost data resulting from any use of or reliance upon the information, whether or not PMC-Sierra, Inc. has been advised of the possibility of such damage.
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
2
FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
Contacting PMC-Sierra
PMC-Sierra 8555 Baxter Place Burnaby, BC Canada V5A 4V7 Tel: +1-604-415-6000 Fax: +1-604-415-6200 Document Information: document@pmc-sierra.com Corporate Information: info@pmc-sierra.com Technical Support: apps@pmc-sierra.com Web Site: http://www.pmc-sierra.com
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
3
FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
REVISION HISTORY
Issue No. 1 2 3 Issue Date January 2000 October 2001 Details of Change Document created Updated for second beta release of FREEDM-NG Driver.
December 2001 Updated for production release of FREEDM-NG Driver.
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
4
FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
1
ABOUT THIS RELEASE
This is release rel-1.0 of the PM7380, PM7381, PM7382, PM7383, PM7384, PM7385 (FREEDM-NG) device driver. Rel-1.0 is intended for use with Revision A of the PM7382 and PM7383 FREEDM-NG devices, and with Revision C of the PM7380, PM7381, PM7384, and PM7385 FREEDM-NG devices. Rel-1.0 is functionally complete and has been tested by PMCSierra as described in Section 4 below. Throughout this document, the driver is referred to as the FREEDM-NG driver. Any information that is unique to a particular device type is explicitly stated.
2
WHAT'S INCLUDED IN THIS RELEASE
This rel-1.0 release of the FREEDM-NG driver includes the following files: Directory
/src
Filename
frd_api.c frd_chnl.c frd_link.c frd_pckt.c frd_diag.c frd_hw.c frd_isr.c frd_rtos.c frd_stats.c frd_util.c
File Version 1.3 1.2 1.2 1.2 1.2 1.3 1.2 1.3 1.2 1.2 1.4 1.3 1.3 1.2 1.3
/inc
frd_api.h frd_defs.h frd_err.h frd_fns.h frd_hw.h
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
5
FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
Directory
/inc
Filename
frd_rtos.h frd_strs.h frd_typs.h
File Version 1.3 1.2 1.1 1.2 1.1 1.3 n/a n/a
/example
frd_app.c frd_app.h
/ / /
Makefile software.lic frd_relnotes_r3.pdf
(this file)
Notes: 1. frd_app.c, frd_app.h contain example callback function implementation and example code.
3
INSTALLATION
Please perform the following steps to install the FREEDM-NG device driver in your system. * Unzip the release zip file, and install the files and its directory structure under your local drive. Modify the directory variable names in the Makefile, if necessary, to reflect your actual driver and directory names. Modify frd_typs.h, frd_hw.h and frd_rtos.h as per your system's characteristics. Also, modify/implement the hardware and RTOS dependent functions in frd_hw.c and frd_rtos.c. Please refer to Section 7 of the FREEDM-NG driver manual (PMC-1991045, Issue 3), Porting the FREEDM-NG driver, for detailed instructions on porting the driver to your specific environment. Set up compile switches or other environment variables in the Makefile. Please refer to the Makefile for a detailed description of the available compile switches. Compile the source files and build the FREEDM-NG driver using your make utility. Link the FREEDM-NG driver to your application code.
*
* * *
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
6
FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
4
TESTING STATUS OF THIS RELEASE
All FREEDM-NG device driver Application Programming Interface (API) functions have been tested in-house using the PM7380, PM7381, PM7384, and PM7385 devices on a proprietary PMC-Sierra, Inc. validation platform running VxWorksTM RTOS. However, the customer is advised to consult our web site (http://www.pmc-sierra.com) for any relevant errata that may have been issued subsequent to the publication of this document.
5
WHAT'S NEW IN THIS RELEASE?
rel-1.0: Production release for the FREEDM-NG device driver
* * * * * Workaround for SBI Tributary External C1FP hardware errata added. In-line documentation has been updated to match the driver manual. New constants for configuring and working with channel and packet structures defined. Register and RAM tests are no longer performed during device initialization. Link type constants have been renamed for clarity. The constants are divided into two groups for SBI and non-SBI devices. Replace the original constant with the updated constant for the device type in use.
PM7380, PM7381, PM7382, PM7383 Link Type Constants Original Name
FREEDM_T1_FRAMED FREEDM_T1_UNSTR FREEDM_T1_UNSTR_BSYNC FREEDM_E1_FRAMED FREEDM_E1_UNSTR FREEDM_E1_UNSTR_BSYNC FREEDM_2M_MVIP FREEDM_8M_MVIP
Updated Name
FREEDM_T1_CHANNELISED FREEDM_T1_UNCHANNELISED FREEDM_T1_UNCHANNELISED_BSYNC FREEDM_E1_CHANNELISED FREEDM_E1_UNCHANNELISED FREEDM_E1_UNCHANNELISED_BSYNC FREEDM_2M_MVIP FREEDM_8M_MVIP
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
7
FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
PM7384, PM7385 Link Type Constants Original Name
FREEDM_T1_FRAMED FREEDM_T1_UNSTR FREEDM_E1_FRAMED FREEDM_E1_UNSTR FREEDM_STR_DS3 FREEDM_UNSTR_DS3
Updated Name
FREEDM_T1_FRAMED FREEDM_T1_UNFRAMED FREEDM_E1_FRAMED FREEDM_E1_UNFRAMED FREEDM_DS3_FRAMED FREEDM_DS3_UNFRAMED
*
Field names and meanings in sFREEDM_OTHER_STATS have been changed to closer reflect the statistics collected. The following table lists the only affected fields. Original Field Name
fcsErrors rxPktFreeFreeDescErr rxPktFreeLargeReads rxPktReadyQErr rxPktFreeReadyReads rxPktFreeSmallReads overflows txFIFOUnderflows txFreeDescErr txPktReadyQWrites txCompletes (new field) txPktRdyQCacheReads unprovTx underflows
Updated Field Name
rxFCSErr rxFreeQueuesEmptyErr rxLargeFreeQueueCacheRead rxReadyQueueFullErr rxReadyQueueWrite rxSmallFreeQueueCacheRead txFIFOOverflowErr txFIFOUnderflowErr txFreeQueueFullErr txFreeQueueWrite txPacketInterruptOnComplete txParityErr txReadyQueueCacheRead txUnprovisionedChannel
(field deleted)
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
8
FREEDM-NG (PM7380, PM7381, PM7382, PM7383, PM7384, PM7385) Device Driver Release Notes
unprovRx
(field deleted)
6
WORKAROUNDS FOR DEVICE ERRATA
The FREEDM-NG device driver performs the following workarounds for the PM7384 and PM7385. * * * * Incorrect T1 CAS Phase Information: the driver changes register 0x6A4 from the default value of 2E to 0x6E on reset. Delay Required After Writing SBI Master Configuration Registers: the driver implements a delay of 10 ms following a write to either SBI Master Configuration Register. Dropped data on Unchannelised DS-3 SBI SPE: the driver sets the SPE mode to T1, delays for 10 ms, and then sets the mode to DS-3. Reset of SBI Tributaries are Required if C1FP is Sourced Externally (such as from a TEMUX): the driver enables the tributary, disables it, delays for 1 ms, and then re-enables the tributary.
The reader is referred to the device errata documents for a detailed description of the device errata. * * PM7384 FREEDM-NG Revision C Device Errata (PMC-2000953, Issue 4) PM7385 FREEDM-NG Revision C Device Errata (PMC-2000954, Issue 4)
Proprietary and Confidential to PMC-Sierra, Inc., and for its Customers' Internal Use Document ID: PMC-1991680, Issue 3
9

▲Up To Search▲

Price & Availability of 1991680

	To Download 1991680 Datasheet File
If you can't view the Datasheet, Please click here to try to view without PDF Reader .